home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 05.zip / BS1 part 5 / IM_3.adf / pi.doc < prev    next >
Text File  |  1992-08-20  |  20KB  |  415 lines
  1.     :
  2.     : Black Belt Systems PI Module Description Document
  3.     :                   Last Update: August 20th, 1992
  4.     :                      Document: Ben Williams
  5.     :
  6.  
  7.     Introduction
  8.     ------------
  9.     This document describes, very briefly, each of the Public Interface
  10.     (PI) modules which are supplied with Imagemaster. All of these modules
  11.     are installed by the proceedure described in the document
  12.     ``PI_Exec.doc'' which you will find on the disk with the installation
  13.     data and programs.  In order to use the PI Modules described here, you
  14.     must complete that installation.
  15.     
  16.     Using PI Modules
  17.     ----------------
  18.     Once the PI Modules have been installed, using them is very, very
  19.     easy.  PI Modules are grouped into five logical ``classes'' of
  20.     operations:
  21.     
  22.         F1 - Load ------ decode and load a specific file format
  23.         F2 - Save ------ encode and save a specific file format
  24.         F3 - Operate --- perform a function on an image in Imagemaster
  25.         F4 - Capture --- fetch an image from a device such as a scanner
  26.         F5 - Generate -- display an image devices such as a 24-bit card
  27.     
  28.     To use a module from one of these classes within Imagemaster, you
  29.     simply press one of five function keys, F1 through F5, as shown at the
  30.     left of the list in the previous paragraph. After pressing a function
  31.     key, you will be presented with a list of the available PI Modules of
  32.     that particular type - pressing F1 brings up a list of all the image
  33.     loader types available. Simply click upon the loader module you wish
  34.     to use and select ``done'', or double-click on the module; either way
  35.     starts the loader running.
  36.     
  37.     In the following portion of this document, we will briefly explain
  38.     each of the modules for all five classes so that you have a reference
  39.     for the types of operations each PI Module performs; also, each of the
  40.     five classes will be explained further.
  41.     
  42.     Load Modules (F1)
  43.     -----------------
  44.     Load Modules are used to decode and load images into Imagemaster, from
  45.     files which have been saved in unusual or alien (from another machine)
  46.     file formats.  Load Modules present you with one (or more, in some
  47.     cases) file requester(s) and allow you to specify where in your
  48.     computer (on which disk and in which directory) the file is, so that
  49.     the loader can find it and load it.
  50.     
  51.         JPEG/JFIF
  52.         =========
  53.         Loads JPEG files which are in JFIF format. JPEG is a file format
  54.         which is ``lossy'', which means that when the image is changed
  55.         into JPEG format, some of the image information is lost. For this
  56.         reason, JPEG images may not be of as high a quality as you usually
  57.         expect from a 24-bit file format. Note that the compression used
  58.         by the JPEG process is extremely effective; so much so that images
  59.         may be only 1/50th of their uncompressed size. Because of this,
  60.         you may find that a JPEG file which appears to be quite small
  61.         uncompresses to a very large image, which you may not be able to
  62.         load into Imagemaster without having additional RAM memory
  63.         available. JPEG images contain a full 24-bits of color
  64.         information. For more information on the JPEG format, see the JPEG
  65.         save module documentation.
  66.         
  67.         IFF Palette
  68.         ===========
  69.         Loads IFF Palettes from IFF images created by most Amiga software.
  70.         These palettes are loaded into Imagemaster's internal paint system
  71.         palette for later use. The currently loaded image is not affected
  72.         by the loading of this palette. IFF Palettes usually contain 12
  73.         bits of color information. On occasion, they will contain 24-bits
  74.         of color information.
  75.         
  76.         PMBC
  77.         ====
  78.         PMBC image files are loaded by this module. PMBC files are true
  79.         color, 24-bit images in a completely lossless format, along with
  80.         an alpha channel and image shape mask. For more information on
  81.         PMBC, see the PMBC save module documentation.
  82.         
  83.         RAW
  84.         ===
  85.         RAW image files are files of literally raw image data. There are
  86.         no extra bits of information describing anything about the image,
  87.         such as it's size or resolution. For color raw images, there need
  88.         to be three separate (but related) image files. One will contain
  89.         the red information, one the green information and one the blue
  90.         information. The RAW loader will present you with a file requester
  91.         for each of these files so that you can specify each one. In
  92.         addition, you need to tell the RAW loader what size the image is,
  93.         since that information is not in the image file itself. RAW files
  94.         contain a full 24-bits of color image data. For more information
  95.         on RAW files, refer to the documentation for the RAW save module.
  96.         
  97.         Rendition
  98.         =========
  99.         Rendition format files are likely to have been produced by
  100.         software from Octree corporation, makers of the Caligari line of
  101.         image rendering systems. Rendition files contain 24-bits of color
  102.         information, and possibly alpha (transparency) information.
  103.         
  104.         Rendition Alpha Channel Data
  105.         ============================
  106.         This loader creates a buffer which you may then use as transparency
  107.         information from the alpha data in a rendition file.
  108.         
  109.         Board Master
  110.         ============
  111.         This loader can load any Board Master file as a B&W graphic image
  112.         of the PCB traces and structures.
  113.         
  114.         PCX Loader
  115.         =========
  116.         This loader will load 2-256 color PCX files.
  117.         
  118.         Animation Frames
  119.         ================
  120.         Animations, in this context, are IFF ANIM OP-5 animations such as
  121.         those produced by Electronic Arts DPaint program, or Imagemaster
  122.         itself. This loader asks you which frame it is you wish to load
  123.         from within the animation. ANIM files may contain normal Amiga
  124.         images, HAM-E images, or DCTV images.
  125.         
  126.         Targa
  127.         =====
  128.         Targa images (usually) come from IBM computers. There are a number
  129.         of different Targa formats; some are 24-bits, some 16-bits and so
  130.         on. So what you get when you load the image will depend upon the
  131.         particular file format ebing used. These images were invented by
  132.         Truevision, Inc.
  133.         
  134.         SHAM (and AHAM)
  135.         ===============
  136.         SHAM, or ``Sliced HAM'', is a format especially designed for the
  137.         Amiga. These HAM-mode files contain palette information for every
  138.         scan line, or some groups of scan lines. When these images are
  139.         loaded, Imagemaster obtains the correct palette information and
  140.         applies it to the 24-bit image it creates in the new buffer. These
  141.         images were invented by NewTek Inc. AHAM is a compatible clone
  142.         from ASDG.
  143.         
  144.         DHRZ (and ARZ0/ARZ1)
  145.         ====================
  146.         DHRZ, or ``Dynamic Hi-Res'', is a format especially designed for
  147.         the Amiga. These hires mode files contain palette information for
  148.         every scan line, or some groups of scan lines. When these images
  149.         are loaded, Imagemaster obtains the correct palette information
  150.         and applies it to the 24-bit image it creates in the new buffer.
  151.         These images were invented by NewTek Inc. ARZ0 and ARZ1 are
  152.         compatible clones from ASDG.
  153.         
  154.         DKB Trace
  155.         =========
  156.         These images are created by the PD Ray-Trace program of the same
  157.         name. They are 24-bit full color images. DKB Trace was written by
  158.         David K. Buck.
  159.         
  160.         RGB8/RGBN
  161.         =========
  162.         These formats contain 24-bit and 12-bit color images,
  163.         respectively. They are created by programs such as Turbo Silver
  164.         and Imagine, from Impulse Inc.
  165.         
  166.         FITS
  167.         ====
  168.         These images are created by software from NASA (National
  169.         Aeronautic and Space Administration) and JPL (Jet Propulsion
  170.         Laboratories). These images (usually) contain images obtained by
  171.         space probes, or similar data. There are many FITS formats; we
  172.         have attempted to support the most common ones. The FITS
  173.         specification is incomplete and contradictory, so some images may
  174.         not load with this PI Module. If this happens to you, please send
  175.         one or more of these image to us on a floppy disk and we will
  176.         attempt to update the loader to handle them.
  177.         
  178.         UPB8
  179.         ====
  180.         These files are saved from our own 256 color paint system for the
  181.         HAM-E. UPB8 files contain images with up to 256 24-bit colors.
  182.         
  183.     Save Modules (F2)
  184.     -----------------
  185.     Save Modules are used to take an image which is already available
  186.     (loaded) inside Imagemaster, encode them (compress and/or encrypt) and
  187.     then save them to a file in a specific format suitable for loading by
  188.     another program, possibly on another type of computer. Save Modules
  189.     present you with a file requester, which you use to specify a location
  190.     for the newly created file to be placed.
  191.  
  192.         JPEG/JFIF
  193.         =========
  194.         JPEG (Joint Photographic Experts Group) format images are highly
  195.         compressed, 24-bit color accurate images. No mask or alpha channel
  196.         information is saved; the image compression method used is
  197.         ``lossy''. This save module provides you with the ability to set
  198.         the compression used from light to heavy. More compression results
  199.         in more loss of image detail.
  200.         
  201.         JPEG is great for some things... and absolutely the worst thing to
  202.         use for others. Consider: JPEG loses some quality when it
  203.         compresses an image. Not a lot, if you use minimum compression,
  204.         but still, some loss of quality occurs. If you're a scientist or a
  205.         doctor, don't think "loses quality", instead think "loses and
  206.         changes data"!
  207.  
  208.         Consider what happens if you're working on this image over a
  209.         number of sessions. Each time you save and load the image in JPEG
  210.         format, it deteriorates a little more (or a lot, if you compress
  211.         it a great deal). The lesson, and the rule that comes from it, is
  212.         obvious:
  213.  
  214.             Don't EVER use JPEG as a storage format for an image you're
  215.             working on, or for an image that will be used in another image
  216.             (unless you positively KNOW that the loss of quality won't
  217.             matter, for whatever reason).
  218.  
  219.         JPEG is really good for archival storage of images you like, but
  220.         aren't "serious" about. On minimum compression, a single use of
  221.         the JPEG technique on an image will not seriously degrade it. And
  222.         that's what you'd normally do with an archived image. Store it
  223.         once, then load it as you please to view it, as many times as you
  224.         like.
  225.  
  226.         PMBC
  227.         ====
  228.         PMBC stands for Plane Minimizing Bitmap Compression. It is a
  229.         format invented at Black Belt Systems for lossless compression of
  230.         high-color images. Using PMBC results in an image file which
  231.         generally will be considerably smaller than the same file in 24-
  232.         bit IFF format, the normal Amiga standard. PMBC is especially good
  233.         at compressing images with gradients and areas of monochrome color
  234.         in them. PMBC is not good at compressing images which contain
  235.         large amounts of dither, such as an image which has been rendered
  236.         to 256 colors for VGA use. You can expect an average improvement
  237.         in storage requirements of about 16% over IFF-24; many images will
  238.         exceed this average by a large amount, particularly those with
  239.         monochromatic (by which we mean B&W, cyan, magenta, yellow, red,
  240.         green or blue) information.
  241.         
  242.         Rendition
  243.         =========
  244.         These images are 24-bit color files. Used with Octree Software
  245.         products on the Amiga.
  246.         
  247.         Vista Binary
  248.         ============
  249.         These images are actually altitude maps in a special binary format
  250.         that Virtual Reality's VistaPro can read. Once saved in this
  251.         format, VistaPro can load the file, and then generate a landscape
  252.         from the data Imagemaster placed in the file.
  253.         
  254.         RAW
  255.         ===
  256.         RAW images contain no control information. Images are saved left
  257.         to right, top to bottom, one byte per pixel in three files: red,
  258.         green and blue. A five-by-five black image that had a dark red
  259.         spot near the upper left would be saved as follows:
  260.         
  261.             red file           green file         blue file
  262.             ----------------------------------------------------
  263.             00 00 00 00 00     00 00 00 00 00     00 00 00 00 00
  264.             00 33 00 00 00     00 00 00 00 00     00 00 00 00 00
  265.             00 00 00 00 00     00 00 00 00 00     00 00 00 00 00
  266.             00 00 00 00 00     00 00 00 00 00     00 00 00 00 00
  267.             00 00 00 00 00     00 00 00 00 00     00 00 00 00 00
  268.        
  269.        For each of the preceeding three files, the bytes are saved in the
  270.        following order:
  271.        
  272.                                  All Files
  273.                                --------------
  274.                                01 02 03 04 05
  275.                                06 07 08 09 10
  276.                                11 12 13 14 15
  277.                                16 17 18 19 20
  278.                                21 22 23 24 25
  279.        
  280.        RGB8
  281.        ====
  282.        This file format is an Impulse file format. Images saved in this
  283.        format can be loaded into Imagine as various brushes and maps.
  284.        RGB8 is a 24-bit byte-level non-lossy compressed format, which is
  285.        generally not as efficient as IFF24 or PMBC; for this reason, you
  286.        normally would only use this for compatibility with Impulse
  287.        products.
  288.        
  289.        Targa
  290.        =====
  291.        This file format is used with Truevision's Targa boards and related
  292.        software on the IBM PC.
  293.     
  294.     Process Modules (F3)
  295.     --------------------
  296.     Process Modules are used to perform operations upon an image which is
  297.     already loaded into Imagemaster. These operations could be something
  298.     as simple as applying contrast, or very complex, somthing like the
  299.     morph function in Imagemaster. Each process will present you with a
  300.     series of control panels appropriate for it's particular needs.
  301.     
  302.         HIST
  303.         ====
  304.         This module will create a text-file containing detailed numeric
  305.         reports on all 256 levels each of red, green, blue, average
  306.         (R + G + B) / 3, and Luma ((R x .30) + (G x .59) + (B x .11)).
  307.         The file will detail each of these five reports, mark the
  308.         name of the image and the total number of pixels involved
  309.         in the analysis. Each level will have a number of pixels
  310.         data item. Lines in the text file which begin with the
  311.         asterisk (*) character are not data lines. Other lines have
  312.         the format:
  313.         
  314.             cNNN:v
  315.         
  316.         Where "c" is R, G, B, L or A for Red, Green, Blue, Luma and
  317.         Average; where "NNN" is a three digit number from "000" to
  318.         "255", leading zeros always present. The colon character ":"
  319.         is always present in a data line. "v" is a number without leading
  320.         zeros that may range from "0" to the number of pixels in the
  321.         region being analyzed.
  322.         
  323.         This module is specifically intended for those analyzing image
  324.         data.
  325.     
  326.         KOCH
  327.         ====
  328.         This PI Module generates a Koch fractal snowflake into the image
  329.         which is the primary image.
  330.         
  331.         Graphs
  332.         ======
  333.         Executing the graph PI Module will bring up a file requester. You
  334.         should select a graph file such as EXAMPLE.GRAPH . The graph will
  335.         then be drawn in a new buffer. There is also an example graph file
  336.         called EXAMPLE.table which you can use to see how to prepare graphs.
  337.  
  338.         Tesselate
  339.         =========
  340.         The PI Module will provide you with a choice of triangle edge
  341.         length.  This is the size of each smooth area on the final result.
  342.         Then you are presented with the normal area selection panel to
  343.         identify the area you want to tessellate on.
  344.  
  345.         Erode
  346.         =====
  347.         'Brightness Erode' thins brighter areas of the image and expands
  348.         darker areas. This can result in a water color paint like effect,
  349.         especially on dithered images.
  350.         
  351.         'Brightness Dilate' does the opposite to Erode. It has a dramatic
  352.         effect on human portraits.  Small cell sizes of 2 to 4 are
  353.         recommended.
  354.         
  355.         Pressing F1 will provide you with a choice between 'Erode' and
  356.         'Dilate'. Then you adjust the cell size.  A larger cell size will
  357.         yield more dramatic results.  Then you are presented with the
  358.         normal area selection panel to identify the area you want to
  359.         change.
  360.  
  361.     
  362.     Capture Modules (F4)
  363.     --------------------
  364.     Capture Modules operate external equipment in such a way as to allow
  365.     you to bring an image into Imagemaster from a real-life source, such
  366.     as an electron microscope, video camera, flatbed or handheld scanner,
  367.     etc. Each Capture Module will provide you with the appropriate
  368.     controls to perform the operation it is intended for.
  369.     
  370.         ES-300c
  371.         =======
  372.         This module is commercial; it is available from Metadigm, Inc.
  373.         You can contact Metadigm at (714) 253-2828. The ES-300c scanner
  374.         module is available stand-alone or as an upgrade from the ASDG
  375.         software for the ES-300c (the upgrade allows you to use the cable
  376.         that came with the ASDG software). If you do own the ASDG scanner
  377.         module, we strongly recommend the Metadigm upgrade; the
  378.         module's performance is better and the module is much easier to
  379.         use.
  380.     
  381.     Display Modules (F5)
  382.     --------------------
  383.     Display Modules are essentially the opposite of Capture Modules. They
  384.     allow you to take an image currently loaded into Imagemaster and
  385.     ``send'' it to a display device such as a 24-bit display card, or a
  386.     photographic imager like the Polaroid Digital Palette. The most common
  387.     use of a Display Module is to view an image on a high-color device.
  388.     
  389.         IV-24
  390.         =====
  391.         This PI Module supports GVP's 24-bit display card, the IV-24. It
  392.         provides output to the IV-24 display only. It cannot be used for
  393.         automatic update operations, as the IV-24 shares the screen with
  394.         the Amiga's display.
  395.         
  396.         FC24
  397.         ====
  398.         This PI Module supports Impulses FireCracker 24 display card. If
  399.         you place the script (rxpi:imfc24r.rexx) in the "Redraw Script"
  400.         text entry field found in the Display panel, and activate the
  401.         "Call Redraw Script" button in the display panel, then as soon as
  402.         Imagemaster completes redrawing on the Amiga screen, it will also
  403.         redraw on the FC24 screen. This allows continuous monitoring of
  404.         the image on the second monitor.
  405.         
  406.         DMI Resolver
  407.         ============
  408.         This PI Module supports Digital Micronics ``Resolver'' 256-color
  409.         24-bit display board. If you place the script (rxpi:resolver.rexx)
  410.         in the "Redraw Script" text entry field found in the Display
  411.         panel, and activate the "Call Redraw Script" button in the display
  412.         panel, then as soon as Imagemaster completes redrawing on the
  413.         Amiga screen, it will also redraw on the Resolver screen. This
  414.         allows continuous monitoring of the image on the second monitor.
  415.